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HII] MM MM GGGGGGGG AAAAAA CCCCCCCC SOTTTTITTTIT CCCCCCCC «=TTTTTTTTTT xx ax 
HI111 MM MM GGGGGGGG AAAAAA CCCCCCCC «=OTTTTTTITTTT CCCCCCCC «=OTTTTTTTTTT xx XX 
I] MMMM MMMM «GG AA AA CC TT cc TT xXx XX 
I] MMMM MMMM 6GG AA AA CC TT cc TT XX XX 
II MM MM MM «(OGG AA AA CC TT cc TT XX = XX 
II MM MM MM «(OGG AA AA ce TT cc TT XX XX 
II MM MM GG AA AA C TT cc TT XX 
I] MM MM GG AA AA CC TT cc TT XX 
II MM MM GG GGGGGG AAAAAAAAAA (CC TT cc TT XX XX 
I] MM MM GG GGGGGG AAAAAAAAAA (CC TT cc TT XX XX 
II MM MM GG GG AA AA CC TT cc TT XX XX eeee 
I] MM MM GG GG AA AA CC TT cc TT XX XX eeee 
IIIIII MM MM GGGGGG AA AA ccccccce TT cccccccc TT XX XX cove 
III MM MM GGGGGG AA AA ccccccce TT cccccccc TT XX XK cove 
SSSSSSSS DDDDDDDD LL 
SSSSSSSS DDDDDDDD LL 
SS DD LL 
SS DD DD LL 
SS DD DD LL 
Ss DD DD LL 
SSSSSS DD DD LL 
SSSSSS DD DD LL 
SS 0D DD LL 
SS DD DD LL 
SS DD DD LL 
SS DD DD LL 
SSSSSSSS DDDDDDDD LLLLLLLLLL 
SSSSSSSS DDDDDDDD LLLLLLLLLL 


AAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AA AAAAAA AAA AAA AAA 
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THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 

{* CORPORATION. 
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{* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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{++ 


Facility: 


~ 


Image Activator Internal Structure Definitions 
Abstract: 


This file contains definitions of the structures used internally 
by the various components of the image activator. 


{ 

{ 

{ 

{ 

{ 

t Author: 

Lawrence J. Kenah 
{ Creation Date: 

15 April 1983 
} Modified By: 


v03-009 rence J. Kenah 9-May-1984 


LJK0280 

Change WRONG_ sys" $18 flag to $Y5. STB. 
LJK 

c 


v03-008 JK0271 nce J. Kena 3-Apr-1984 
4 they bittietds” = TACSGL. ImAGe TX. eeten” nteeet iancent 


eanup. 


v03-007 LJK0267 Lawrence J. Kenah 28-Mar-1984 
Add room in CTX storage area for global Section name. 


{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
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SY 
v03-006 wac0001 Weyne Cardoza 23-Jan-1984 
I1CB image Length should be 44 
Add callers mode to own ttprage 
Add pointer to sequential load ISDs 
v03-005 LUK0240 Lawrence J. Kenah -Aug-1983 
Add control flag for writable shareable images. 
v03-004 LJK0237 Lawrence J. Kenah oho dylaiees 
Add cell for image base address and flag to indicate 
that privileges are to be removed. 
v03-003 LUK0225 Lawrence J. Kenah 7-Jul-1983 
Add own storage data cells needed for compatibility mode 
images. 
v03-002 LJK0215 Lawrence J. Kenah 24-Jun-1983 
Keep Image Control Block definition here until naming issues 
{ are sorted out. The name ICB is already in use by the network. 


(<< 


6 
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podule CTXDEF; 
CTX = Image Activator Context Block 
These Softaitione Ceoce tie | e impure storage ag is torres beryeen 


two routines inside the nage activator. The block Fp! cally 
allocated on the stack with its address stored fn the I 
aggregate cl CTXDEF structure prefix CTX_; 
Longword unsigned; /* Address to read image header into 
IHDOBUF onguere + Bnd ned; /* Address of decoded image header 
VBN nonguer /* Next VBN of header to read 
1SD_OF FSET sar uke lene’: /* Offset within block to next ISD 
AIKS w ord; /* Contents of last word of first block 
GENERATION: word unsigned; /* Version number fis nage header 
ay _1 word fill; /* Spare word for f 
GSD NAME character Length 48; /* fete 2. space for 68 name 
constant LENGTH’ equals . prefix CTX_ tag C ize of context area 


constant “LENGTH equals . prefix CTX_ tag Ki /* Size of context area 
end CTXDEF; 
end_module CTXDEF; 


y 
< 


{ 
! 
c 
{ 
{ 
{ 
{ 
{ 
c 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
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nodule OWNDEF ; 
OWN = Image Activator OWN Storage 


These definitions Gener the the OWN storage used by the image activator. 
This storage exists in several Pl pages and is used to contain all of 
the information that is needed to describe a given activation but is 
not required after the activation completes. 


aggregate OWNDEF structure prefix ‘"'; 
I hey pA FLAGS Sotwe ters itogs°er unsigned; /* py attributes 


lowi ng two Lags are mutually exclus 
MAIN PR Gan bi a mas /* Activation of main program 
MERGE bitfield mask /* Merged activation 
IMAGE Pesvuee bitfield Stes, /* Image accounting. enabled 
REMOVE PRIV LEG bitfield mask; /* Remove CMKRNL and CMEXEC privilege 
TRANSFER R.BIAS . STORED bitfield mask; /* Set to indicate that transfer array bias has been stored 
P1_M + Mah oyeiaete mask; /* Indicates PO part of P1 merge 


ae 
LOCK eorATus BLOCR’ structure quoter unsigned; 
COCK_STATUS word unsigne 
word fill; 
LOCR_ID Longword unsigned; 
end Cock STATUS_BLOCK; 
FILE NAME SIZE word unsigned; /* Size in bytes of image file name 


OTHER NCHARNEL word unsigned; /* Channel on which primary image file is opened 
PINAL =s7ATUs Longuere unsigned; /* Ultimate ceturn status from SYSSIMGACT 

OTHER KFE_ADDRES porenere unsigned; /* Address of KFE that describes primary image file 
TRANSFER ARRAY ee iAs Longvord unsigned; /* Amount by which to adjust transfer addresses 
USER_STACK Sizk longword unsigned; 


ey GE_10 SEG _SIZE Lon word unsi ned; 
L_AMODE a uns toned ° /* Callers mode 

oul ty byte dimension HULL; 

SEQ"LOAD_ISDS Longword unsigned; /* Address of ISDs for sequential load 

RMS_BASE™ Longword unsigned; /* Address of alternate RMS dispatcher 


{ The following cells are used to keep safe copies of the various 
{ components of the argument List. 


end | 
RETURN_ARRAY_ADDRESS Tonguord unsigned; 
RETURN- ADDRESS arts c apecurture qua word unsigned; 
RETURN_START_A ongword unsigned; 
N-END ADDR DRESS aknapwore unsigned; 
T_ADDRESS 


I 
INPUT {DENT “structure” ase o junsigned; 
MATCH CONTROL lLongword unsigne eg: 
VE ERS ION structure longword ons gned; 


un” 
et 


{ 
{ 
¢ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
: 
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MINOR_ID bitfield Length 24 mask; 
MAJOR_ID bitfield length mask; 
VERSION; 


end INPUT_I ; 
ACCESS_MODE Longword unsigned; 
constant ‘‘OWN_STORAGE_SIZE"' equals . prefix '"' tag ‘"'; /* Size of OWN storage 
end OWNDEF ; 
end_module OWNDEF ; 


{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
c 
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module SICBDEF; 
ICB = Image Control Block 


There is one image control bloc. for each image (executable or 
shareable) that is currently mapp 1 into process address space. 


aggregate ICBSDEF structure prefix ICB$; 
FLINK | /* Forward Link in List 


ongword unsigned; 


BLINK lLongword unsigned; /* 
SIZE word unsigned; /* 
TYPE byte une tenee: /* 
constant ICB_T PE_CODE equals 127 prefix (BS ta 
1CB_1 ayes FILL; /* 
ACCESS MODE byte yns igned; /* 
ACT_COBE byte unsigned; /* 
constant 

( MAIN_PROGRAM /* 

» MERGED_IMAGE /* 

GLOBAL_IMAGE_SECTION / 


® 
equals 1 increment 1 prefix ICBS tag K; 
CHAN word unsigned; /* 
FLAGS Structure longword unsigned; /* 


EXPREG bitfield mask; /* 
SHAREABLE bitfield mask; /* 
OPEN_FOR WRITE bitfield mask; /* 
RES_READER bitfield mask; /* 
B_IMAGE bitfield mask; /* 
INITIALIZE bitfield mask; /* 
DONE bitfield mask /* 
SYS_STB bitfield mask; /* 
end FLAGS; 
/* The image name is stored as a counted ASCII 
IMAGE_NAME character length 40; /* 


FILL T tongword fill; 
IDENT’ structure quadword unsigned; 
MATCH CONTROL structure longword unsigned; 
MATCH CONTROL bittield ength 3 mask; 


en 3 

VERSION structure longword unsigned; 
MINOR_ID bitfield length ¢‘ mask; 
MAJOR_ID bitfield length mask; 

4 end VERSION; 
en : 

ADDRESS_RANGE structure quadword ynsigned; 
STARTING ADDRESS longword unsigned; 
END_ADDRESS Longuord unsigned; 
end ADDRESS_RANGE ; 


IHD Longword unsigned; /* 
KFE lLongword unsigned; /* 
CONTEXT Longword unsigned; /* 
BASE_ADDRESS Longword unsigned; /* 
INITIALIZE longword unsigned; /* 


Backward Link in List 
Size of ICB in bytes 
Structure type for ICB 


Spare for alignment 
Access mode of image 
Activation code 


Object of RUN command 
Additional image scopes 
Image described by global ISD 


Channel on which image file is opened 
Name attributes 

Image mapped at end of address space 
Image installed /SHAREABLE 

Image will be opened for write 

mye header already decoded 

Load image from sequential device 
Image contains initialization code 
Image is completely activated 

Image is Linked against SYS.STB 


string. 
Name string (counted ASCII) 


Address of IHD for image 
Address of KFE for image 
Address of context biogk 
Base address at which image is mapped 
Address of initialization code 


{ 
{ 
{ 
{ 
{ 
¢ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
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constant “‘LENGTH’’ equals . pref 
constant "LENGTH" equals . pref 
end ICBSDEF; 

end_module SICBDEF; 


te ate 
xx 


: 
: 
: 
: 
| 
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module SIMAGCTXDEF; 


+ 
IMAGCTX = Context of Currently Executing Image 


The ag ey he bitfields are stored in the cell IAC$GL_IMAGCTX in the 
image activator context page in Pl space. 


The Low order 16 bits of this word contain context that survives for 
the Life of an image. This word is cleared by image rundown. 


The high order word passes context from Fhe joage act tyator service 
running in exec mode to the SIMGFIX service that runs in user mode. 
rae wre is cleared each time that the image activator service is 

entered. 


PSAPAAAAOAAAAAS 


aggregate IMAGCTXDEF union prefix IMAGCTXS$; 
BITS structure Longword fill; 
EXEONLY bitfield mask; /* Execute sp FES 


PRIV bitfield mask; ‘ /* Image installed with enhanced privilege 
BITS_1 bitfield LENGTH 16=-* fill; /* Get to start of second word 

SETVECTOR bitfield mask; /* Privileged vectors to be installed 
INITIALIZE bitfield mask; /* Shareable image initialization 

REORDER bitfield mask; /* Initialization order is significant 


end BITS; 
end IMAGCTXDEF; 
end_module SIMAGCTXDEF; 


{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
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{ 
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